home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu275.dms / pu275.adf / darkplay / DarkPlay.DOC < prev    next >
Text File  |  1992-02-09  |  13KB  |  289 lines
  1.  
  2.             Darkplay v4.5 (12.01.1992)
  3.                                 By
  4.                            Mikko Ruokojoki
  5.               *****************
  6.  DISCLAIMER
  7.  ----------------------------------------------------------------------------
  8.  The  author is  NOT  responsible  for the  suitability  or accuracy  of this
  9.  documentation  and/or  the  program(s) it describes.   Any  damage  directly
  10.  or indirectly caused by the use or misuse of  this documentation  and/or the
  11.  program(s) it describes is the responsibility of the user her/him self.
  12.  ----------------------------------------------------------------------------
  13.  
  14.  COPYRIGHT
  15.  ----------------------------------------------------------------------------
  16.  This program may be  distributed  non-commercially only  providing that  the
  17.  executable,  source  code,  documentation  and   copyright  notices   remain
  18.  unchanged  and are included with the distribution.  This program is FREEWARE
  19.  so no  financial donation  is  necessary  (but welcome). You can find  my
  20.  address  at   the   end   of   this   documentation.
  21.  ----------------------------------------------------------------------------
  22.  
  23.  PACKET
  24.  ----------------------------------------------------------------------------
  25.  DarkPlay             - main program
  26.  DarkPlay.DOC         - main program documentation
  27.  History.TXT          - history of DarkPlay versions.
  28.  
  29.  DarkPlay also needs PowerPacker.library if you want to use PP-modules.
  30.  ----------------------------------------------------------------------------
  31.  
  32.  
  33.  TABLE OF CONTENTS:
  34.  
  35.  OVERVIEW                           I
  36.  STARTING DARKPLAY                 II
  37.  MAINWINDOW MENUS                 III
  38.  MAINWINDOW GADGETS                IV
  39.  HOW TO USE ALARM                   V
  40.  WHERE YOU CAN FIND THE MAKER      VI
  41.  TEMPLE OF AMIGA                  VII
  42.  
  43.  ----------------------------------------------------------------------------
  44.                                    I. OVERVIEW
  45.  ----------------------------------------------------------------------------
  46.  Darkplay was programmed on  an  Amiga 3000 (25Mhz) Kick 2.0
  47.  with 2.6 Meg memory and 40+105Meg HardDisk. 
  48.  DarkPlay is a module player. It plays NoiseTracker (NT),ProTracker (PT)
  49.  modules and modules packed with PowerPacker. You can use it from CLI.
  50.  
  51.  It has many specialites that other players don't have, for example
  52.  music equalizers. Instead of playing music with usual Vertical Blanking
  53.  interrupt it uses CIA-interrupt, so it plays modules right in NTSC-mode too.
  54.  This version of DarkPlay has the following features:
  55.  
  56.  o - a complete intuition user interface.
  57.  o - fully multitasking.
  58.  o - enables to load over 500 modules in menus by making many pages of them.
  59.  o - music Equalizers & Analyzers.
  60.  o - fully CD-interface!
  61.  o - can be iconified.
  62.  o - Clock alarm support. For example you can put DarkPlay start playing
  63.      module at 6 am.
  64.  o - OS2.0 support.
  65.  o - Auto detaching from CLI.
  66.  o - etc. etc. etc...
  67.  
  68.  ----------------------------------------------------------------------------
  69.                               II. STARTING DARKPLAY
  70.  ----------------------------------------------------------------------------
  71.  SYNTAX:
  72.  
  73.  Darkplay [?]
  74.  
  75.  Everything in braces [] is optional.
  76.  
  77.  ? = The program tells you some info about it and quits.
  78.  So you just have to write "Darkplay" and the program will be ready
  79.  to use.
  80.  ----------------------------------------------------------------------------
  81.                               III. MAINWINDOW MENUS
  82.  ----------------------------------------------------------------------------
  83.  MAIN:
  84.  ----
  85.  LOAD CONFIG     - Loads Config file (Darkplay.CFG) from current path or S:
  86.  SAVE CONFIG     - Saves Config to S:-path.
  87.  ABOUT           - About text with little info.
  88.  REFRESH WINDOW  - Redraws everything on window.
  89.  ICONIFY         - Iconifies DarkPlay.
  90.  TASKPRIORITY    - Changes DarkPlays task priority.
  91.               -2 - Good when you want use other progs at same time.
  92.                0 - (Default)
  93.                2 - When you want to see Equalizers and others work at maxium
  94.                    speed.
  95.  QUIT            - Cleans up everything and quits the program.
  96.  
  97.  
  98.  MUSIC CONTROLS:
  99.  --------------
  100.  
  101.  PLAY            - Starts playing current module.
  102.  STOP            - Stops playing. The music position will be cleaned!
  103.  PAUSE           - Pauses music until you choose PAUSE again.
  104.  EJECT           - Rejects the current module from mem.
  105.  NEXT PATTERN    - Moves to next pattern.
  106.  PREV PATTERN    - Moves to previous pattern.
  107.  GOTO START     - Goes to start of module.
  108.  NEXT MODULE     - Moves to next module.
  109.  PREV MODULE     - Moves to previous module.
  110.  SHOW SAMPLES    - Shows the Sample names from module. If there is no module
  111.                    it will be empty.
  112.  
  113.  PREFS:        (All thing in here will saved to config)
  114.  -----
  115.  EQUALIZER 1     - Activates Equalizer number one.
  116.  EQUALIZER 2     - Activates Equalizer number two.
  117.  EQUALIZER 3     - Activates Equalizer number three.
  118.  NO EQUS         - Deactivates all Equalizers.
  119.  VOLUMEANALYZ.   - Activates/DeActivates VolumeAnalyzers.
  120.                    Tells you a volume from each chanel.
  121.  CHOOSE PATH     - Opens path-requester for path where the modules are.
  122.                    It loads the dir to menus and you can choose the modules
  123.                    from there.
  124.  FILTER          - Put power filter ON/OFF.
  125.  
  126.  LOAD ONLY MOD.* - If you have this flagged the program will load only
  127.                    MOD.-starting modules to the menus.
  128.  
  129.  DOUBLE BUFFER     - When this is ON the program uses double buffering when loading
  130.                    new module, the old one is still playing in background until
  131.                    the another module has been loaded. Then it will free the
  132.            other buffer and goes on playing.
  133.  
  134.  PLAY MODS ONCE  - Means that when this is ON, module will be played only ONCE.
  135.  
  136.                    BTW: When you are using Program Mode this will be
  137.                    automatically ON.
  138.  
  139.  TRACKS 1:
  140.  --------
  141.  
  142.  PROGRAM MODE    - When you choose this, do:
  143.                     1. Select the modules you want to play.
  144.                     2. Select PLAY or NEXT MOD. and the music will start.
  145.                     3. when you are PLAYing you can select
  146.                        NEXT MOD. or PREV. MOD.
  147.                     4. Switch this OFF and you are in normal state, or select
  148.                        more module and play those.
  149.        WARNING:
  150.                  - Sometimes program can crash if you choose more than 40
  151.                    modules to program.          
  152.  
  153.  CLEAR PROGRAM   - This clears the program. After this you can choose new
  154.                    modules.
  155.  NEXT MOD. PAGE  - Works only if you have more than 40 modules in dir so
  156.                    you can take the next page of the modules...
  157.  PREV MOD. PAGE  - Works only if you have more than 40 modules in dir so 
  158.                    you can take the previous page of the modules...
  159.  
  160.  MODULES...      - 18 item places for modules.
  161.  
  162.  
  163.  TRACKS 2:
  164.  ---------
  165.  MODULES...      - 22 item places for modules.
  166.  
  167.  ----------------------------------------------------------------------------
  168.                              IV. MAINWINDOW GADGETS
  169.  ----------------------------------------------------------------------------
  170.  
  171.  -------------------------------------
  172.  I1 2   --  --  --  --  3    4 --:-- I
  173.  I+ <--------STATUS LINE------------>I
  174.  I+ <POSITION--->  <SPEED---> -+     I   <-- This is Professional WindowSize.
  175.  I+ <MEM SHOW--> <CIA SPEED-> -+     I
  176.  I+ <FLAGS: DPOA> <5>                I
  177.  I+ <CD-INTERFACE GADGETS----------->I
  178.  -------------------------------------
  179.  
  180.  -------------------------------------
  181.  I1 2   --  --  --  --  3    4 --:-- I
  182.  I  <--------STATUS LINE------------>I   <-- This is Normal WindowSize.
  183.  I  <CD-INTERFACE GADGETS----------->I
  184.  -------------------------------------
  185.  
  186.  1 = Iconify Gadget, Iconifies DarkPlay.
  187.  2 = Professional WindowSize ON/OFF
  188.  3 = VolumeAnalyzers ON/OFF.
  189.  4 = Setting ALARM. When push this DarkPlay opens a new window where you set
  190.      the alarm time. More from this look below.
  191.  5 = Place where the program mode count comes.
  192.  
  193.  STATUS LINE   - Here you can see whats happening in DarkPlay.
  194.                  IDLE     - Waiting for user to do something.
  195.                  PLAYING  - Playing music
  196.                  STOPPED  - Music has been stopped.
  197.                  PAUSED   - Music has been paused.
  198.                  LOADING  - DarkPlay is loading new module.
  199.                  LOAD CFG - DarkPlay is loading config.
  200.                  SAVE CFG - DarkPlay is saving a new config.
  201.                  SLEEPING - When Alarm is SET this will bound to window if
  202.                             anything isn't happening. When you see this
  203.                             the DarkPlay is ready alarm. NOTICE that you have to
  204.                             have module loaded. Otherwise DarkPlay can't play it!
  205.  POSITION      - Here you can see the module position.
  206.                  01:01/25 -\--- The first "01" is the pattern position.
  207.                             \--- The "01" is the real position.
  208.                              \--- The "25" is the lenght of module patterns
  209.                                    it will play.
  210.  SPEED         - Here you see the current speed. 1 is very fast and
  211.                  32 is very slow. You can change this by pressing little
  212.                  buttons beside this.
  213.  MEM SHOW      - Here you see the available memory.
  214.  
  215.  
  216.  CIA SPEED     - Here you see the current CIA speed. You can change this by
  217.                  pressing little buttons beside this.
  218.  
  219.  FLAGS         - With this you can see easy what switches are ON and OFF.
  220.                  When there is "-" it means that the flag is OFF.
  221.                  FLAGS:
  222.                   "D" = Double Buffer is ON
  223.                   "P" = Program Mode is ON
  224.                   "O" = Play Mods once is ON
  225.                   "A" = Alarm has been set. Waiting for alarm time.
  226.  
  227.  CD-INTERFACE GADGETS
  228.                - With these you can control the playing very well.
  229.                  I think that you know to use them without helping.
  230.  
  231.  ----------------------------------------------------------------------------
  232.                                V. HOW TO USE ALARM
  233.  ----------------------------------------------------------------------------
  234.  First push the Alarm Gadget(looks like Clock). The select a time when
  235.  alarm and set the alarm ON. Then push SET or CANCEL.
  236.  Then you load some module to mem and push STOP or something so
  237.  there is "SLEEPING" in STATUS LINE. Now the Darkplay is ready
  238.  to wake-up! You can put ICONIFY-mode on if you want to.
  239.  
  240.  ----------------------------------------------------------------------------
  241.                         VI. WHERE YOU CAN FIND THE MAKER
  242.  ----------------------------------------------------------------------------
  243.  You can write to Mikko Ruokojoki:
  244.  
  245.                                  Mikko Ruokojoki
  246.                                  Pohjolankatu 22
  247.                                  00610 Helsinki
  248.                                      FINLAND
  249.  
  250.            And tell if there is some bugs or something to fix or add.
  251.          All money contributions are accepted too. With little cash you
  252.    can help me to do better player. Please put the money to envelope and send
  253.         me. If want to ask something, then you can caught me from my BBS:
  254.  
  255. -----------------------------------------------------------------------------
  256.                               VII. TEMPLE OF AMIGA!
  257. -----------------------------------------------------------------------------
  258.  
  259.            ..... ..... .   . ..  .    .....
  260.              .   .     .. .. . . .    .      .  ....
  261.              .   ....  . . . ..  .    ....  ... ...
  262.              .   .     . . . .   .    .     ... .
  263.              .   ..... .   . .   .... .....  .  .
  264.  
  265.             **      **    ** **  ****        **
  266.            ****     ***  *** ** **  **      ****
  267.           **  **    ********    **         **  **
  268.           **  **    ** ** ** ** **         **  **
  269.          ********   **    ** ** **  **    ********
  270.         **      **  **    ** ** **   **  **      **
  271.        **        ** **    ** ** ******  **        **
  272. _________________________________________________________________________
  273.  
  274.     Hardware: Amiga3000 (2MB Chip,1MB Fast), working on 25Mhz
  275.                    processor, 68882 mathproc. and 40+105 Quantums
  276.  
  277.        SysOp: Mikko Ruokojoki
  278.  
  279.         Open: 24h
  280.        Speed: 22,22bis
  281.  
  282.        Phone: 90-790760 (+358-0-790760)
  283.  
  284.        Other: Lots of Amiga files! Many active door-games!
  285.                   Many good guys and friendly SysOp.
  286.                   No NPD Stuff.
  287.                   Has been working over two years now.
  288. _________________________________________________________________________
  289.